KCFindNextItem

KCFindNextItem
Header:	Keychain.h		Carbon status:	Under Evaluation

Finds the next keychain item matching the previously specified search criteria.

OSStatus KCFindNextItem (
    KCSearchRef search, 
    KCItemRef *item
);

Parameter descriptions

search: A reference to the previously-specified search criteria. Pass the reference passed back in the searchRef parameter of the function KCFindFirstItem.
item: On return, a pointer to the next matching keychain item, if any.

function result: A result code. The result code errKCNoDefaultKeychain indicates that no default keychain could be found. The result code errKCItemNotFound indicates that no matching keychain item was found. The result code errKCInvalidSearchRef indicates that the specified search reference was invalid.

DISCUSSION

The KCFindNextItem function finds the next keychain item matching the search criteria previously specified by a call to KCFindFirstItem. KCFindNextItem returns a reference to the matching item, if any. KCFindNextItem will automatically call the function KCUnlock to display the Unlock Keychain dialog box if the keychain containing the item you are searching for is currently locked.

SPECIAL CONSIDERATIONS

When you are completely finished with a search, you should the functions KCReleaseItem and KCReleaseSearch to release the keychain item and search criteria reference.

VERSION NOTES

Available beginning with Keychain Manager 1.0.